docs: document the dev-server OOM workaround for large generations - #808

Summary

Adds a "Troubleshooting" section to the Getting Started docs documenting the dev-server out-of-memory crash that occurs when generating large content locally. The note explains the Jest worker encountered 2 child process exceptions, exceeding retry limit symptom, clarifies it is a dev-only Next.js worker-fork limitation rather than an OpenMAIC runtime bug, and gives the maintainer's heap-size workaround (NODE_OPTIONS=--max-old-space-size=4096) for both macOS/Linux and Windows PowerShell. The fix was previously only in a single issue comment, so the next local user hitting this crash now has a documented path. This documents the existing dev-only workaround only and does not claim a code fix; production builds are unaffected.

Related Issues

Fixes #625

Changes

• Add a "Troubleshooting" section to packages/docs/content/docs/getting-started.mdx, placed after the ## Run section, documenting the dev-server OOM symptom, its root cause (dev-only Next.js worker fork for App Router dynamic routes), and the NODE_OPTIONS=--max-old-space-size=4096 workaround for macOS/Linux and Windows PowerShell.

Type of Change

• Documentation update

Verification

Steps to reproduce / test

1. Open packages/docs/content/docs/getting-started.mdx.
2. Confirm the new ## Troubleshooting section renders after ## Run and before ## Build for production.
3. Confirm both shell code blocks (macOS/Linux and Windows PowerShell) display correctly.

What you personally verified

• Verified the new section is the only change (single-file, additive diff) and the MDX structure (frontmatter + headings + fenced code blocks) is well-formed.
• Verified the documented command text matches the maintainer's workaround in Turbopack Jest worker 在 LLM 生成大内容时崩溃 #625, adjusted to the docs' pnpm dev convention.
• I did not run a full local OOM reproduction; the change only surfaces the maintainer's already-confirmed workaround and does not alter any runtime code.

Evidence

• CI passes (pnpm check && pnpm lint && npx tsc --noEmit)
• Manually tested locally
• Screenshots / recordings attached (if UI changes)

Checklist

• My code follows the project's coding style
• I have performed a self-review of my code
• I have added/updated documentation as needed
• My changes do not introduce new warnings

AI was used for assistance.